[[!toc]]

[[!map pages="wiki/ferramentas/pelican*"]]

---

# Descricao

Pelican is a static site generator, written in Python.

- Write content in reStructuredText or Markdown using your editor of choice
- Includes a simple command line tool to (re)generate site files
- Easy to interface with version control systems and web hooks
- Completely static output is simple to host anywhere

<https://github.com/getpelican/pelican/tree/3.6.3>

---

# Instalacao

Conforme o [manual][a]:

    pip install --user --upgrade pelican markdown tzlocal

# Criar um blog novo

    mkdir -p ~/blog
    pushd ~/blog
    pelican-quickstart

Neste ponto, e' necessario seguir as instrucoes da tela.

## Problemas conhecidos

Se o comando `pelican-quickstart` nao for encontrado, e porque os binarios nao estao na variavel `$PATH` do shell. Solucao: [[/tutorial/acrescentar_ao_path]]

# Publicar

A partir daqui, e necessario adicionar arquivos em `content/`.

Quando estive pronto, usar o comando:

    pelican content

Isto vai compilar o conteudo e gerar html no diretorio `output/`.

O servidor web deve servir o que esta neste diretorio.

# Testando

Para testar sem servidor web, da pra usar este comando:

    pushd ~/blog/output
    python -m pelican.server

Um servidor de teste deve estar escutando em <http://localhost:8000>.

[[!meta title="Pelican"]]

[[!tag pelican python ferramenta cms]]

[a]: http://docs.getpelican.com/en/stable/quickstart.html#installation

